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Invoking the Batch Files 



C Operators 



Phone Numbers 

Tl Customer Response Center (CRC) 

Hotline: (800) 232-3200 
Grephics Hotline: (713)274-2340 

Invoking the Preprocessor 

[ gspcpp [input file] [options] 



gspcpp 
input file 
options: 



is the command that invokes the preprocessor, 
is a C source file; it usually has an extension of .c. 



-c copies comments to the output file. 

-d/iame[=def] defines name as if it appeared in 
a #define statement. 

Adir adds dir to the list of directories that are 
searched for ^include files. 

-p inhibits generation of line number and file in- 
formation. 

-q suppresses the banner and status information. 

The preprocessor creates an output file with an extension of 
xpp. 

Invoking the Parser 

| gspcc [input file] [options] I 



gspcc 
input file 

options: 



is the command that invokes the parser. 

is a modified source file created by the pre- 
processor; it has an extension of .cpp. 



-z retains the input file. 

-q suppresses the banner and status information. 

The parser creates an output file with an extension of .//. 

Invoking the Code Generator 

| gspcg [input file] [options] \ 

gspcg is the command that invokes the code generator. 

input file is an intermediate file created by the parser; it has 
an extension of .if. 

options: 

-a indicates that the program contains aliasing. 
-o places symbolic debuging directives in the 

output file. 
-q suppresses the banner and status information. 
-r writes a register-status table to the output file, 
-s uses the small-code model. 
-x checks for stack overflow at run time. 
-z retains the input file. 

The code generator creates an assembly-language output file 
with an extension of .asm. 



gspc [input file] 



gspq [input file] 



gspc invokes the gspc. bat batch file to invoke the 

compiler and assembler. This batch file prints 
banners and status messages and retains the inter- 
mediate .asm file. 

gspq invokes the gspq. bat batch file, to invoke the 

compiler and assembler. This batch file is a quiet 
version that does not print any messages; note that 
this batch file deletes the intermediate .asm file. 

input file is a C source file. Don't specify an extension; the 
batch files assume an extension of .c. 



Linking a C Program 



gsplnk -c filenames -o name. out -I its. lib -I flib.lib 

or 
gsplnk -cr filenames -o name.out -I rts.lib -I flib.lib 



-c/-cr are options that tell the linker to use special con- 

ventions necessary in the C environment. 

filenames are object files created by compiling and assem- 
bling a C program. 

-o name.out names the output file. If you don't use -o, the 
linker creates an output file with the default name 
of a . out. 

rts.lib is the archive library that contains runtime-support 

functions; the -I option tells the linker that a file 
is an object library. 

flib.lib is the archive library that contains floating-point 

functions; the -I option tells the linker that a file 
is an object library. 

Additional options that you may want to use when linking C 
code include: 

-m creates a map file. 

-r retains relocation entries in the output file. 

-i names directories that contain object libraries. 

Environment Variables 





Set 


Reset 


DOS 


set C— DlR=pathy ... ;path n 


set C— DIR= 


VMS 


assign "pathj; ... ;path n " C— DIR 


deassign C— DIR 


UNIX 


setenv C— DIR "pathy ... ;path n " 


setenv C— DIR " " 


MPW 


set C— DIR "pathy. ... ;path n " 
export C— DIR 


unset C— DIR 



TMS34010 Data Types and sizes 



Type 


Size 


char 


8 bits, signed ASCII 


unsigned char 


8 bits, ASCII 


short 


16 bits 


unsigned short 


1 6 bits 


int 


32 bits 


unsigned int 


32 bits 


long 


32 bits 


unsigned long 


32 bits 


pointers 


32 bits 


float 


32 bits 

Range: ±5.88 x 10 ' 39 thru 
±1.70 x 1038 


double 


64 bits 

Range: ±1.11 x 10 '30% thru 
±8.99 x 10 308 


enum 


1-32 bits 



Highest Priority 


Operators 


Associativity 


() 


[] 


-> 


left to right 


i 
(type) 


* 


++ 

& sizeof 


right to left 


* 


/ 


% 


left to right 


+ 


- 




left to right 


>> 


<< 




left to right 


< 


<= 


> > = 


left to right 


== 


! = 




left to right 


& 


left to right 




left to right 


1 


left to right 


&& 


left to right 


II 


left to right 


? : 


right to left 


/= 

1 = 


+= 
% = 
<<= 


_= * = 
&= A = 
>> = 


right to left 




left to right 


Lowest Priority 



Runtime-Support Functions 



Header File: assert. h 



void assert(expression) 
int expression; 



Header File: ctype.h 



int isalnum(c) 
char c; 



int isalpha(c) 
char c ; 



int isascii(c) 
char c ; 



int iscntrl(c) 
char c; 



int isdigit(c) 
char c ; 



int isgraph(c) 
char c ; 



int islower(c) 
char c; 



int isprint(c) 
char c; 



int ispunct(c) 
char c ; 



int isspace(c) 
char c; 



int isupper(c) 
char c ; 



int isxdigit(c) 
char c; 



char toascii(c) 
char c; 



char tolower ( c ) 
char c; 



char toupper(c) 
char c; 



Runtime-Support Functions 



Header File: math.h 



double acos(x) 
double x; 



double asin(x) 
double x; 



double atari (x) 
double x; 



double atan2(y, x) 
double y, x; 



double ceil(x) 
double x; 



double cos(x) 
double x; 



double cosh(x) 
double x; 



double exp(x) 
double x; 



double fabs(x) 
double x; 



double floor(x) 
double x; 



double fmod(x, y) 
double x, y; 



double frexp(value, exp] 
double value; 
int *exp; 



double ldexp(x, exp) 
double x; 
int exp ; 



double log(x) 
double x; 



double loglO(x) 
double x; 



double modf (value, ' iptr) 
double value; 
int *iptr; 



double pow(x, y) 
double x, y; 



double sin(x) 
double x; 



double sinh(x) 
double x; 



double sqrt(x) 
double x; 



double tan(x) 
double x; 



double tanh(x) 
double x; 



Header File: stdarg.h 



type va— arg ( ap , type ) 

va— list ap 



void va— end(ap) 
va— list ap 



void va_ start (ap, parm) 
va— list ap 



Runtime-Support Functions 



Header File: stdlib.h 



int abs(j) 
int j ; 



void abort () 



void atexit(fun) 
void (*fun) ( ) ; 



int atof(nptr) 
char *nptr; 



int atoi(nptr) 
char *nptr; 



long int atol(nptr) 
char *nptr; 



void *bsearch(key, base, nmemb, 
size, compar) 
void *key, *base; 
size— t nmemb, size; 
int (* compar) ( ) ; 



void *calloc( nmemb, size) 
size— t nmemb, size; 



void exit( status) 
int status; 



void free(ptr) 
void *ptr; 



int labs(j) 
int j ; 



int ltoa(n, buffer) 
long n; 
char *buffer; 



void *malloc(size) 
size— t size; 



void *minit() 



char *raovmem(src,dest, count) 
char *src, *dest 
int count ; 



void qsort(base, nmemb, size, compar) 
void *base; 
size— t nmemb, size; 
int (* compar) ( ) ; 



int randd 



void *realloc (ptr , size) 
void *ptr; 
size— t size; 



int srand(seed) 

unsigned int seed; 



double strtod(nptr, endptr) 
char *nptr, ** endptr; 



long int strtoKnptr, endptr, base) 
char *nptr, **endptr; 
int base; 



unsigned long int strtouKnptr , endptr, 

base) 
char *nptr, **endptr; 
int base; 



Header File: string. h 



void *memchr(s, c, n) 
void *s; 
int c; 

size— t n; 



int meracrnp(sl, s2, n) 
void *sl, *s2; 
size— t n; 



void *memcpy(sl, s2, n) 
void *sl, *s2; 
size— t n; 



void *memmove(sl, s2 , n) 
void *sl, *s2; 
size_t n; 



Runtime-Support Functions 



Header File: string. h (continued) 



void *raernset(s, c, n) 
void *s; 
int c; 
size_t n; 



char *strcat(sl, s2) 
char *sl, *s2; 



char *strchr(s, c) 
char *s; 
int c ; 



int strcrap(sl, s2) 
char *sl, *s2; 



int *strcoll(sl, s2) 
char *sl, *s2; 



char *strcpy(sl, s2) 
char *sl, *s2; 



size— t strcspn(sl, s2) 
char *sl, *sl; 



char *strerror(errnum) 
int errnum; 



size_t strlen(s) 
char *s; 



char *strncat(sl, s2, n) 
char *sl, *s2; 
size— t n; 



char *strncmp(sl, s2, n) 
char Nl, *s2; 
size—t n; 



char *strncpy(sl, s2, n) 
char *sl, *s2; 
size—t n; 



char *strpbrk(sl, s2) 
char *sl, *s2; 



char *strrchr(s ,c) 
char *s; 
int c; 



size_t *strspn(sl, s2) 
char *sl, *s2; 



char *strstr(sl, s2) 
char *sl, *s2; 



char *strtok(sl, s2) 
char *sl, *s2; 



Header File: time.h 



char *asctime(timeptr) 
struct tm *timeptr; 



clock— t clock () 



char *ctirae(timeptr) 
struct tm *timeptr; 



double dif ftirae(timel,timeO) 
time— t timel, timeO; 



struct tm *gratime (timer] 
time— t * timer; 



struct tm *localtime (timer) 
time— t *timer; 



time— t mktime(timeptr] 
struct tm *timeptr; 



size—t strf t ime ( s , maxs ize , t imeptr ) 
char *s, *format; 
size—t maxsize; 
struct tm *timeptr 



time— t time (timer) 
time— t * timer; 
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double acos(x) 
double x; 



void add— text— space(n) 
int n; 



double asin(x) 
double x; 



double atan(x) 
double x; 



double atan2(u,v) 
double u,v; 



void bit— expand(srcbits, srcpitch, w, h, xleft, ytop) 
short srcbits[]; 
long srcpitch; 
int w, h, xleft, ytop; 



void bound— fill(x, y, buffer, sire, fa- 
int x, y, size; 
char buffer[]; 
unsigned long b— color; 



color) 



void bound— patnfill(x, y, buffer, size, fa- 
int x, y, size; 
char bufferf]; 
unsigned long b— color; 



color) 



double ceil(x) 
double x; 



int char— high() 



int char— wide— max() 



void clear— screen(pixval) 
long pixval; 



int close— vuport(index) 
int index; 



void color— blend (pxlval, y1, y2, redl, grnl, blul, 
red2, grn2, blu2) 
int pxlval, y1, y2; 
int redl, grnl, blul; 
int red2, gm2, blu2; 



typedef long FIX 

void copy— matrix(matrixin, matrixout) 

FIX matrixin[16]; 

FIX matrixout[16]; 



void copy— vertex(n, vertexin, vertexout) 
typedef long FIX; 
int n; 
FIX vertexin [], vertexout[]; 



int copy— vuport(index1, index2) 
int index"!, index2; 



double cos(x) 
double x; 



double cosh(x) 
double x; 



double cotan(x) 
double x; 



int cpw(x, y) 
int x, y; 



void delay(n) 
int n; 



int draw— char(x, y, c) 
int x, y; 
char c; 



void draw— Iine(x1, y1, x2, y2) 
int x1, y1, x2, y2; 



void draw— oval (w, h, xleft, ytop) 
int w, h, xleft, ytop; 



void draw— ovalarc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void draw— piearc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void draw— point(x, y) 

int x, y; 



void draw— polyline(n, linelist, ptlist) 
int n; 
short linelist [], ptlist[]; 



void draw— rect(w, h, xleft, ytop) 
int w, h, xleft, ytop; 



int draw— string(x, y, s) 

int x, y; 
char *s; 



double exp(x) 
double x; 



double fabs(x) 
double x; 



int fill— convex(n, edgelist, ptlist) 
int n; 
short edgelist[], ptlist []; 



void fill— oval(w, h, xleft, ytop) 
int w, h, xleft, ytop; 



void fill— piearc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void fill— polygon(n, linelist, ptlist) 
int n; 
short linelistfj, ptlistQ; 



void fill— rect(w, h, xleft, ytop) 
int w, h, xleft, ytop; 



float "fix— to— f loat(n, in— array, out— array) 
typedef long FIX; 
int n; 

FIX in— array[]; 
float out— array[]; 



long "fix— to— long(n, in— array, out— array) 
typedef long FIX; 
int n; 

FIX in— array[]; 
long out— array[]; 



short *fix— to— short(n, in— array, out— array) 
typedef long FIX; 
int n; 

FIX in— arrayf]; 
short out— array []; 



global FIX2FL 



.global FL2FIX 



global FL-ADD 



.global FL-COS 



.global FL-MULT 



.global FL-SIN 



FIX "float— to— fix(n, in— array, out— array) 
typedef long FIX; 
int n; 

float in— arrayf]; 
FIX out— array []; 



double floor(x) 
double x; 



double fmod(x, y) 
double x, y; 



void frame— oval(w, h, xleft, ytop, dx, dy) 
int w, h, xleft, ytop; 
int dx, dy; 



void frame— rect(w, h, xleft, ytop, dx, dy) 
int w, h, xleft, ytop; 
int dx, dy; 



double frexp(value, exp) 
double value; 
int *exp; 



void getall— palet(palet— array, reg— mask, y) 
short palet— array [16]; 
int reg— mask, y; 



int get— ascent() 



int get— descent() 



int get— first— ch() 



int get— font— max() 



int get— last— ch() 



int get— leading() 



int get— patn— max() 



int get— pixel(x, y) 

int x, y; 



long get— pmaskQ 



long get— ppop() 



int get— psizeQ 



void get— rect(w, h, xleft, ytop, darray, dpitch) 
int w, h, xleft, ytop; 
short darray[] 
long dpitch; 



int get— transp() 



int get— vuport— max() 



int get— width(s) 

char *s; 



void init— grafixQ 



void init— matrix(matrix) 
typedef long FIX; 
FIXmatrix[16]; 



void init— palet() 



void init— screen() 



void init— text() 



int init— video(monitor— val) 
int monitor— val; 



void init— vuport() 



int install— font(index, fontname) 
int index; 
FONT 'fontname; 



int install— patn(index, pattern) 
int index; 
short pattern [1 6]; 



double ldexp(value, exp) 
double value; 
int exp; 



char *lib_id() 



int lmo(n) 
long n; 



double log(x) 
double x; 



double Iog10(x) 
double x; 



FIX *long— to— fix(n, in— array, out— array) 
typedef long FIX; 
int n; 

long in— array[]; 
FIX out— array []; 



double modf(value, exp) 
double value; 
int "exp; 



void move— pixel (xs, ys, xd, yd) 
int xs, ys, xd, yd; 



void move— rect(w, h, xs, ys, xd, yd) 
int w, h; 
int xs, ys, xd, yd; 



void move— vuport(xleft, ytop) 
int xleft, ytop; 



void new— screen (pixel, palet) 
long pixel; 
short palet[16]; 



int open— vuport() 



int patnfill— convex(n, edgelist, ptlist) 
int n; 
short edgelist[], ptlist[]; 



void patnfill— oval (w, h, xleft, ytop) 
int w, h, xleft, ytop; 



void patnfill— piearc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void patnfill— polygon(n, linelist, ptlist) 
int n; 
short linelist[], ptlist[]; 



void patnfill— rect(w, h, xleft, ytop) 
int w, h, xleft, ytop; 



void patnframe— oval(w, h, xleft, ytop, dx, dy) 
int w, h, xleft, ytop; 
int dx, dy; 



void patnframe— rect(w, h, xleft, ytop, dx, dy) 
int w, h, xleft, ytop; 
int dx, dy; 



void patnpen— Iine(x1, y1, x2, y2) 

int x1, y1, x2 y2; 

void patnpen— ovalarc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void patnpen— piearc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void patnpen— point (x, y) 

int x, y; 



void patnpen— polyline(n, linelist, ptlist) 
int n; 
short linelist[], ptlist[]; 



int peek(address) 
long address; 



long peek— breg(breg) 
int breg; 



void pen— Iine(x1, y1, x2, y2) 
int x1 , y1 , x2, y2; 



void pen— ovalarc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void pen— piearc(w, h, xleft, ytop, theta, arc) 
int w, h, xleft, ytop; 
int theta, arc; 



void pen— point(x, y) 

int x, y; 



void pen— polyline(n, linelist, ptlist) 
int n; 
short linelist[], ptlist[]; 



void perspec(n, vertlist, ptlist, xview, yview, zview) 
typedef long FIX; 
FIX vertlist []; 
short ptlist[]; 
int n, xview, yview, zview; 



void poke(address, value) 
long address; 
int value; 



void poke— breg (breg, value) 
long breg; 
int value; 



double pbw(x, y) 
double x, y; 



void put— pixel(val, x, y) 
int val, x, y; 



void put— rect(sarray, spitch, w, h, xleft, ytop) 
short sarray[]; 
long spitch; 
int w, h, xleft, ytop; 



long rep— pixel (val) 

int val; 



int rmo(n) 
long n; 



void rotate(matrix, angle) 
typedef long FIX; 
FIX matrix[16], angle[3]; 



void run— decode(xleft, ytop, image) 
int xleft, ytop; 
short image[]; 



int run— encode(w, h, xleft, ytop, image, maxbytes) 
int w, h, xleft, ytop, maxbytes; 
short image[]; 



void scale(matrix, factor) 
typedef long FIX; 
FIX matrix[16], factor[3]; 



void seed— fill(xseed, yseed, buffer, maxbytes) 
int xseed, yseed, maxbytes; 
char bufferf]; 



void seed— patnfill(xseed, yseed, buffer, maxbytes) 
int xseed, yseed, maxbytes; 
char buffer[]; 



int select— font(index) 
int index; 



int select— patn(index) 
int index; 



int select— vuport(index) 
int index; 



void setall— palet(palet, reg— mask, n, y) 
short palet[16]; 
int reg— mask, n, y; 



void set— cliprect(w, h, xleft, ytop) 
int w, h, xleft, ytop; 



void set— colorO(pixel- 
long pixel— val; 



-val) 



void set— colorl (pixel— val) 
long pixel— val; 



void set— origin(xO, yO) 

int xO, yO; 



void set— palet(reg, red, grn, blu) 
int reg, red, grn, blu; 



void set— pensize(w, h) 

int w, h; 



void set— pmask(mask) 
long pmask; 



void set— ppop(ppop- 
int ppop— code; 



-code) 



FIX 'short— to— fix(n, in— array, out— array) 
typedef long FIX; 
int n; 

short in— array[]; 
FIX out— array[]; 



double sin(x) 
double x; 



double sinh(x) 
double x; 



int size— vuport(w, h) 

int w, h; 



double sqrt(x) 
double x; 



long styled— Iine(x1, y1, x2, y2, style, mode) 
int x1, y1, x2, y2, mode; 
long style; 



double tan(x) 
double x; 



double tanh(x) 
double x; 



void transform(matrix, n, verts) 
typedef long FIX; 
FIXmatrix[16], verts[]; 
int n; 



void translate(matrix, disp) 
typedef long FIX; 
FIXmatrix[16], disp[3]; 



void transp— off() 



void transp— on() 



void vertex— to— point(n, verts, ptlist) 
int n; 
FIX verts []; 
short ptlist[]; 



void wait— scan (line) 
int line; 



long xytoaddr(x, y) 

int x, y; 



void zoom— rect(ws, hs, xs, ys, wd, hd, xd, yd, linebuf) 
int ws, hs, xs, ys; 
int wd, hd, xd, yd; 
short linebuff]; 



